KeyTouch - The easy way to enable multimedia-keys!

This guide will explain the installation and configuration of the two basic KeyTouch tools. Keytouch allows the selection of profiles to select your keyboard model from a list in its database. If your keyboard is not present, you can "train" it by starting up keytouch editor and pressing the relevant keys whilst identifying them.

It comprises of two tools: * KeyTouch - The tool to setup a keyboard that is already in the database. Currently supported models are listed in a table at the bottom of this page.

* KeyTouch-Editor - The tool to setup your keyboard by teaching it. You select your multimedia keyboards input, then press keys and identify them from a drop down list. Save the configuration file when your done and simply import into Keytouch itself^.

Installing KeyTouch & KeyTouch Editor

Open a terminal and enter these commands:

sudo apt-get install keytouch keytouch-editor

Using KeyTouch

You should now be able to find KeyTouch under System > Administration.

On initial startup, you'll be asked for the model of your keyboard. Select from the list of supported models and click "OK". You'll then be taken to the Key settings tab where some keys will be filled in with default values. You can switch these around or enter custom program launchers or common actions (e.g. Copy, Paste, Redo, Close Window, etc). Extra plugins with actions for specific programs are available in the Preferences tab. In the Keyboard tab you can switch your selected keyboard (requires a program restart).

Using KeyTouch-Editor

You can find KeyTouch-Editor under System > Administration.

In Ubuntu 8.10 the KeyTouch-Editor launcher is found under System > Preferences.

On initial startup, you'll be asked to choose from a list of inputs, KeyTouch will name them. Try all of the inputs which look similarly named to your device, as often you have more than one listed (Extra function keys are usually listed on the second input, while your main keyboard will use the first input, both should be similarly named). After you select an input it will ask you to push all of the multimedia keys, until one is detected, just to make sure you have indeed selected the right input. You'll then be taken to the Key settings tab where you can add keys, simply by pressing them and identifying them. Some keys will be filled in with default values (Information is gleaned from inputs manufacturers have named). You can switch these around or enter custom program launchers or common actions (e.g. Copy, Paste, Redo, Close Window, etc). Extra plugins with actions for specific programs (eg. Amarok Music Player) can be used.When its done and you have configured all the buttons Keytouch can detect, simply save it to your desktop. Then open up Keytouch and click import, find that file on your desktop and import it. Then select your keyboard model on the list (the one you have now added!) and you can now use keytouch to configure/change what the keys do.

Getting help

See the KeyTouch project page for the latest full documentation: http://keytouch.sourceforge.net/doc.php PDF Manual: http://prdownloads.sourceforge.net/keytouch/keytouch-2.2-user_manual.pdf?download HTML Manual: http://keytouch.sourceforge.net/user_manual/user_manual.html

Supported Keyboard Models